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INTRODUCTION 


SQUASH/USER. DISK is a normal-state program ‘that conselidaces the 
| available ‘$torage areas ona user disk pack or cartridge while 
‘other programs are executing in the M®ixe Unlike the squash 
procedures  avaitabtle through. the operating Systene 
SQUASH/USER.DISK can run with other programs in the mixe at though 
mene of the other programs can be accessing the Pigk white Ao 
being squashed. The disk being squashed is made unavailable by 
the areca ne Pe rre and flagged as “OFF LIWt YET IN USE". 


aman DOCUMENTATION 


Nawe | _ =, | Number 


| B1800/B1700 Software Oper ationat. Guide | 10687 31 


— 61600761700 MCP Utilities PeSe 2212 5579 


21 


BURROUGHS CORPORATION ; COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP | B1AODO/B1700 SQUASH/USER.DISK 


SANTA BARBARA PLANT | | | ——  PeSe 2222 2574 (8B) 
OPERATING INSTRUCTIONS 
To initiate the $Quashs» the user should enter: 
"EX SQUASH/USER DISK?" 
The program will respond with the following @essayes 
ENTER UNIT TU Of SQUASHED: DP? OR CC?” 
The user should respond with the unit to be squasheds 
<job-number >AX<unit mnemonic> 


If the unit is available» then SQUASH/USER.GISK will perform the 
squashe It wall print a List of the disk contents hoth tefore 
and after the squash» in a format similar to that of a KA. 
Before gaing to E0J it will display: —- | | 


"WAXIMUM CONTITGUNUS SPACE AVAILABLE [5 "<integer> SLETORS™ 
"TOTAL SPACE AVAILABLE IS "<integer> SFCTURS” ~ a 
"SQUASH COMPLETE" pe 


Just 2s with the MCP squash» it is advisabte to verify the 
integrity of the disk» both before and after a squash. 
DISKMAP/UTILITY» for example» checks for ary errors in disk 
integritys COISKMAP/UTILITY is discussed in P.Se 2212 5579» MCP 
Utilities.) a | | ; sa, Ans 


INIEGRITY CHECK 


SQUASH/USERDISK will check the disk for overlapping sectors 
before beginning the squash. If any averlapping areas are found» 
it will print their size and location: 


OVERLAPPING SECTORS ON UNIT OPEL LABELLED DOCGRP 


1 SECTOR OVERLAPPING STARTING AT SECTOR Q2000A88a 

1 SECTOR OVERLAPPING STARTING AT SECTOR 2000A3DaQ 

19 SECTORS GQVERLAPPING STARTING AT SECTOR JOO0OA8EQ | 
79 SECTORS OVERLAPPING STARTING AT SECTOR Q000AD12 ~ 
128 SECTORS OVERLAPPING STARTING AT SECTOR 39000154 
100 SECTORS OVERLAPPING STARTING AT SECTOR Q00EEADA 
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‘Overlapping areas cause the program to abort before doing the 


Squash» displaying the message: 


<integer> OVERLAPPING AREAS == SQUASH AnoRTED 


SRUASH/USERAUTISK will atso check the availahte tanhoa See . ae 
of-sequence or zero~tlength antries. [hase with be Fl aguet ue tte. 
first WA Listing, and tne prograt witt he aborted after 


displaying the messages 


BAD AVAILABLE TABLE =-- SQUASH ARORTED 


EU TIME OPTIONS 


Once the squash has begune the user can set various 


usInNg the "AX" SPQ command: 


<job-number>AXx<cption> 


Possitle options include: 


“SIZE The orogram witt display the current address» 


maximum 
contiguous space available and the total space avait- 
able. 
9TOP The program will termirate at the first convenient 


options, 


opportunity. The program should rever he OS~ed while 
it 9s running? *STop" should be used insteaq. : 


NEED «n> ~~ This tells the proaram that <n> contiguous sectors 


are needed. The program will terminate as. 


soon as 


the requested amount of space is made available. 


TRACE <n> This sets the TRACE opticn. n> wfust be either Or Ls» 


2 or 3. sea TRACE FEATURES in this section. 
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squashe [ft 1s especially useful for recovery in the lan 
system fathure while SQUASH is axecutinge | 
IRACEE9 
Nothing wilt be traced. This 15 the devant 
Ipact=l 
Each piece of data is traced when it is Jaen 
TRACE=2 
tach disk I/70 Cread or write) is traced. 
IRACE=3 
fach disk I/0 (read Se Gee 1S tracece including the contents 


of the read/write buffer. 
Samote trace output? 
TRACE=1 Dutout 


AVAILABLE TABLE MOVED FROM 200095Fa 10 200004242 
FILE HEADER MOVED FROM 39000784 TO 2600048a 
SUB-DIRECTORY MOVED FROM 209008A2 TO 300904Fa_ 


FILE AREA MOVED FROM a00009Aa TN 2000053a 


> . 
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JEFACE=2 Output 


READ agdgneCa 
WRITE aNCOO6Fa 
READ aANDOO0bE 
WRITE @0009GEa 


READ gUC003Cad 


dhAce=s Uutout 
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KEAD aAVOQOQO SCG F 21000031000000000F 210000 500F 21000975 00NOBFE «see 


WRITE 20000302 F21000031099000900F 210090 300F 21000079 0000ALF «eee 
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ERROR RECOVERY 


Lf SQUASHK/USER.DISK is abnormally terminated» either because of a 
Clear/Start» OS» or program failure» then the input disk may be 
corruptede Howevere it should be passible tc recover most of the 
Gata The user should run OISKMAP/UTILITY to discover what» if 


anye errors there are. 


Using the CESKMAPSUTIN ITY outoute alany 


mith € MA of the disk before and after the saquath»e shnul t Waee 2 
possible to salvage the disk. 


fo do this» it ts necessary to understand the order of tne squash 


operation. fEacn piece of data starting with the lowest address 


is movedq into the Lowest 


avatiahbte cisk address. The steps of 


the saquash cccur in this sequence? 


1) the data 1s movede 


co. Relatives are inforned of the move (Cfor exampler. a 


fitetheader must 

2) #+x°£5The old space is 

4) The new space 15 

How much information ts 


doing when it was aborted. 
to tett what was heing 


attemct to recover the tost 


bad ~sereas and using TAD 
recover dost tnformatione 


he told tf one of Its areas ts moved). 


returned to the Available anne 


removed from the Available Table. 


fost depends on what the program was 
From the KAe the user should be able 
moved at the time cf the failure and 
datae This can be done by removing 
Cinstallaticn allocated disk) files to 


Cae | 


Cad 
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The tollowing errors are nonfatal. lf user input is requireds 
(he progran witl request 3 response and then wath far an 4k 
MANTEGO 


cunit> IS AN INVALID UNIT NAST 


Valid unit names are OP<tletter> ard CC<letter>. 


<unit> COULD NUT SE ASSIGNED 


The unit could not be assigned to the proyram. Check that tt 195 
onwlines and has no userse | 


<unit> LABELLED <nane> IS NOT A USER DISK 


Unly user disks can be squashed by SQUASH/USER.DISK 


<ontion> [5 NOT A KAOQWN OPTION 


The user entered an invalid option. 


VALUE OF <value> FOR <opticn> IS NOT NUMERIC 


TRACE and NEED require numeric values. 


TRACE CANNOT 3£ SET TO <value> 
TRACE can only be set to O» le 2 or 3 
NOT READY 


| ON <unit> -~ PLEASE CORRECT AND AX WITH OK 
WRITE LOCKOUT. | | 


The unit being squasted has gone not ready or awrite Lockout has 
occurred. The urit should be readied or write enabled in order 
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for the squash to continue. The procram will wait until the user 
enters <job-number>AX OK before continuing. 


FATAL ERRORS 


The fellowing sessages appear when the progran discovers an 

uncarrectable error. They will he followed by tne messaqe: 
SQUASH ABORTED 

Tf S@UASH/USERDISK terminates abnormally» the disk wilt not be 

readied. The user should ready the unitt aad check its integrity 


before using ite Tne disk may be bad» so the user should fottlorn 
the instructions tn the ERROR RECOVERY sectior. 


ID UNCORRECTED AFTER 19 RETRIES 


A disk I/0 error could not he corrected. 


INVALID FILE HEADER AT SECTOR <nex address> 
A file header contained invatid information? 
13 More than 105 areas were reouested for the filer or 


2) The number of assiqned areas was greater than the 
number of areas requestede | 


PROGRAM EREFCR 
The squash could not continue due to a programmatic error. A 


memory dump will be generated before the program goes to EOQJ- 
save the dump and write a Trouble Refort. | | 


<integer> OVERLAPPING AREAS 


See the INTEGRITY CHECK section. 
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SAD AVATLARLE TABLE 


See the INTEGRITY CHECK section. 
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